home *** CD-ROM | disk | FTP | other *** search
/ MacWorld 1999 November / Macworld (1999-11).dmg / Shareware World / Info / For Developers / Smile1.6.6.sea / Smile1.6.6 / Smile ƒ / Help files / Find dialog < prev    next >
Text File  |  1999-08-17  |  4KB  |  75 lines

  1. The "Find" Dialog ("Edit" menu)
  2.  
  3.  
  4. Selecting "Find..." ("Edit" menu  F) will open the "Find" dialog box. A text or script window must be the front window while selecting the menu. Here is how the dialog works.
  5.  
  6.  
  7. Find field : the search string.
  8.  
  9. Enter the search string in this field. Press the tab key ()(with the dialog box active) to toggle selection between "Find" and "Replace" fields. 
  10.  
  11.  
  12. Replace field : the replace string.
  13.  
  14. Enter the replace string in this field which you want to replace the search string in all its occurrences. See below the description of the "Replace all" button.
  15.  
  16.  
  17. Find button
  18.  
  19. Clicking this button will select the next occurrence of the search string in the active window (according to the settings, see below). If the search string cannot be found in the active window, Smile will beep. If the Multi-file search box is checked, the behavior is different. See below "Multi-file search".
  20.  
  21.  
  22. Replace all button
  23.  
  24. Click this button to replace all the occurrences of the search string by the replace string.
  25.  
  26. "Replace all" always operates on the whole contents of the window, whatever the state of the "wrap" checkbox.
  27. "Replace all" is undoable.
  28.  
  29.  
  30. wrap checkbox
  31.  
  32. (this checkbox not effective in Multi-file search mode).
  33. If unchecked, Smile searches only the text after the selection. If checked, Smile searches, first, the text after the selection, then (if there is no hit at this point) the text before the selection. 
  34.  
  35.  
  36. case sens checkbox
  37.  
  38. If unchecked, the search considers lowercase and uppercase characters the same (case is ignored). Searching "John" will find "JOHN" as well as any other mix of J-O-H-N upper/lower case letters.
  39.  
  40.  
  41. Multi-file search checkbox
  42.  
  43. Check this box to perform a search of all the files contained in a given folder, including the files contained in nested folders (a hierarchical search). The search is restricted to text and script files, whatever their creator (file types "TEXT" and "osas"). 
  44.  
  45. The field below the checkbox displays the pathname of the selected folder, if any folder has already been selected.
  46.  
  47. In Multi-file search mode, Smile does not select the found string(s). Instead it will open the "Worksheet" if not open, and write some lines in this window.
  48.  
  49. For each file where the string has been found, Smile will write two script lines, followed by the quotation of the first paragraph of the file where the search string was found. 
  50.  
  51. Example :  Suppose you are searching for the string "John" in your "Mail archive" folder, you might get the following output in the Worksheet :
  52.  
  53. DoOpen("Macintosh HD:Internet:Mail archive:Re - Hello world")
  54. set selection of window 1 to {98,102}:
  55. ----------------------------------------
  56. From       : John
  57. ----------------------------------------
  58.  
  59. The search string "John" was found in the file "Re - Hello world". The line between dashed lines is a copy of the first paragraph of this file containing the string "John".
  60.  
  61. The two lines above the quotation are a small script which will open the file, and highlight the found string (the script may vary, depending whether the file is text or a script). To execute this script, select the two lines, then press the Enter key (be careful, do not press the carriage return key   instead). (You should be familiar with running scripts in text windows.)
  62.  
  63. Even if the string exists in multiple places in the file, only the first occurrence will be reported in the Worksheet. You must open the file (by executing the small script), then use the "Find next" command of the "Edit" Menu (shortcut  G), to find the next occurrence(s) of the search string in this file.
  64.  
  65. If the search string is not found, Smile will open a "not found" dialog box at the end of the search. 
  66.  
  67. A multi-file search may take a few minutes to complete. The search can be terminated by depressing (and holding) the Command and period keys ( .) until the busy cursor (spinning wheel) changes to an arrow. 
  68.  
  69.  
  70. Choose folder …
  71.  
  72. Click this button to choose the folder to search. The name of the selected folder will be displayed in the field below the button.
  73.  
  74. ========================================================
  75.